Obiekt App: Właściwości Python, lub formalnie
App::FeaturePython
, jest prostą instancją App: Obiekt dokumentu w środowisku Python.
Jest to prosty obiekt, który domyślnie nie ma wielu właściwości, na przykład nie ma umiejscowienia lub kształtu topologicznego. W zależności od przypisanych mu właściwości, może być używany do zarządzania różnymi typami danych.
Uproszczony diagram zależności pomiędzy podstawowymi obiektami w programie FreeCAD.
App: Właściwości Python jest obiektem wewnętrznym, więc nie można go utworzyć z poziomu interfejsu graficznego. Jest on przeznaczony do tworzenia klas podrzędnych, które będą obsługiwać różne typy danych.
Na przykład obiekty Adnotacja wieloliniowa, Wymiar i Pośrednia płaszczyzna robocza w środowisku pracy Rysunek Roboczy są obiektami App::FeaturePython
z niestandardową ikoną i dodatkowymi właściwościami. Przechowują one dane, ale nie rzeczywisty obiekt kształtu topologicznego.
Jeśli pożądany obiekt ma mieć umiejscowienie, kształt, dołączenie lub inne złożone właściwości, lepiej jest utworzyć jedną z bardziej złożonych klas, na przykład App: Cechy geometrii, Część: Cecha lub Część: Część na obiekt 2D.
Zobacz stronę Właściwości dla wszystkich typów właściwości, które mogą mieć obiekty tworzone skryptami.
Klasa App: Właściwości Python (App::FeaturePython
) jest pochodną podstawowej klasy App: Obiekt dokumentu (App::DocumentObject
) i dziedziczy wszystkie jej właściwości. Posiada również kilka dodatkowych właściwości.
Są to właściwości dostępne w edytorze właściwości. Ukryte właściwości można wyświetlić za pomocą polecenia Wyświetl wszystko w menu kontekstowym edytora właściwości.
Podstawa
PythonObject
): niestandardowa klasa powiązana z tym obiektem.String
): edytowalna przez użytkownika nazwa tego obiektu, jest to dowolny ciąg UTF8.String
): dłuższy, edytowalny przez użytkownika opis tego obiektu, jest to dowolny ciąg UTF8, który może zawierać nowe linie. Domyślnie jest to pusty ciąg ""
.ukryte
): lista wyrażeń. Domyślnie jest pusta []
.Bool
): czy obiekt ma być wyświetlany czy nie.
Podstawa
PythonObject
): niestandardowa klasa Dostawca widoku powiązana z tym obiektem.Opcje wyświetlania
Enumeration
): domyślnie jest puste.Bool
): wartość domyślna to PRAWDA
, w którym to przypadku obiekt pojawi się w oknie widoku drzewa. W przeciwnym razie obiekt zostanie ukryty w oknie drzewa. Gdy obiekt w drzewie jest niewidoczny, można go ponownie zobaczyć, otwierając menu kontekstowe nad nazwą dokumentu (prawym przyciskiem myszki) i wybierając PRAWDA
.Bool
): wartość domyślna to PRAWDA
, w którym to przypadku obiekt będzie widoczny w oknie 3D view, jeśli posiada kształt, w przeciwnym razie będzie niewidoczny. Domyślnie właściwość ta może być włączana i wyłączana poprzez zaznaczenie obiektu i naciśnięcie przycisku Spacja.Wybieranie
Enumeration
): kontroluje sposób, w jaki zaznaczenie pojawia się w oknie widoku 3D, jeśli obiekt ma kształt, a istnieje wiele obiektów częściowo zakrytych przez inne. Domyślnie Wyłączone
, co oznacza, że nie pojawi się żadne specjalne podświetlenie. Włączone
oznacza, że obiekt pojawi się na wierzchu każdego innego obiektu po wybraniu. Object
oznacza, że obiekt pojawi się na wierzchu tylko wtedy, gdy cały obiekt zostanie wybrany w oknie Widoku drzewa. Element
oznacza, że obiekt pojawi się na wierzchu tylko wtedy, gdy element podrzędny (wierzchołek, krawędź, ściana) zostanie wybrany w oknie widoku 3D.Enumeration
): kontroluje sposób podświetlenia obiektu, jeśli ma on kształt. Jeśli jest to kształt
, cały kształt (wierzchołki, krawędzie i ściany) zostanie podświetlony w oknie widoku 3D; jeśli jest to Ramka otaczająca
, pojawi się obwiednia otaczająca obiekt i zostanie podświetlona.
Zobacz również: Podstawy tworzenia skryptów FreeCAD, oraz Obiekty skryptowe.
Ogólne informacje na temat dodawania obiektów do dokumentu można znaleźć na stronie Część: właściwość.
Obiekt App: Właściwości Python jest tworzony za pomocą metody dokumentu addObject()
.
import FreeCAD as App
doc = App.newDocument()
obj = App.ActiveDocument.addObject("App::FeaturePython", "Name")
obj.Label = "Custom label"